home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / nosey_ii.lzh / NOSEY_II.DOC < prev   
Text File  |  1992-10-30  |  9KB  |  198 lines
  1.  
  2.    p **************************** q
  3.    p *                          * q
  4.    p *     NOSEY II             * q
  5.    p *     Version 1.0          * q
  6.    p *     Copyright 1992   /~  * q
  7.    p *     F10 Software   @/    * q
  8.    p *                          * q 
  9.    p **************************** q
  10.  
  11.  
  12.    WHAT IS NOSEY ?
  13.  
  14.    If you are like me, you have many disks filled with AEOs, STRs and
  15.    lists of online library files. When you want to find information on a
  16.    subject you have to load a file into your text reader and then do a
  17.    search. Wrong file, OK, load the next file and search again - this is
  18.    very time consuming. Here is where NOSEY comes in. NOSEY lets you
  19.    search up to 50 files at a time and matches can be printed to your
  20.    printer or to a disk file. Boolean AND, OR and NOT searches are
  21.    supported. Nosey II runs as a program or a desk accessory.
  22.  
  23.    NOSEY is not a text reader, it is a locator. You will probably want
  24.    to use your normal text reader to peruse the file once you've located
  25.    the information you need.
  26.  
  27.    To use Nosey as an program, change the file extension from .ACC to
  28.    .PRG
  29.  
  30.    **********************************************************************
  31.    *                                                                    *
  32.    *   Nosey II is shareware which means that it can be freely          *
  33.    *   distributed. It is not "public domain". If you decide that this  *
  34.    *   program is valuable enough for you to keep and use, please pay   *
  35.    *   for it. The suggested price is $10.                              *
  36.    *           Make out your check to:                                  *
  37.    *           Frank Vuotto                                             *
  38.    *           F10 Software                                             *
  39.    *           Box 2201                                                 *
  40.    *           Taos, New Mexico - 87571                                 *
  41.    *   Thanks in advance for your support.                              *
  42.    *                                                                    *
  43.    **********************************************************************
  44.  
  45.    SELECTING FILES
  46.  
  47.    Clicking on a box brings up the ST file selector. Selecting a file
  48.    adds it into the search list.
  49.  
  50.  ~ SELECT MULTI
  51.    Select up to 50 files. When you have selected all the files you want
  52.    to search, click the fileselector "CANCEL" button.
  53.  
  54.  ~ SELECT ALL
  55.    Automatically selects the first (up to) 50 files in a directory and
  56.    adds them to search list. The two buttons labeled "1-25" and "26-50"
  57.    toggle between showing the first and second 25 selected files. All
  58.    selected files are searched.
  59.  
  60.  ~ CLEAR
  61.    Deselects all files on the search list.
  62.  
  63.  ~ CULL
  64.    While cull is selected, clicking on a file name clears it from the
  65.    search list. It is often easier to use SELECT ALL and then CULL the
  66.    files you don't want searched.
  67.  
  68.  ~ FILE MASK
  69.    If a file mask is selected only files with that extender are shown in
  70.    the file selector and selected with SELECT ALL. The default is ".*"
  71.    which shows all files. Note that the last box ".ASC" can be edited.
  72.    You can switch the input cursor between the search string input and
  73.    this box with the up and down arrows on the middle ST keypad. Be sure
  74.    to select this box by clicking on it after changing the file extension.
  75.  
  76. -- SEARCH STRING OPTIONS --
  77.  
  78.    Up to 26 characters may be entered in the search string field. Using
  79.    spaces can help "clean up" a search. For example "st" will find
  80.    "start" and "stop"  but "st " won't. You can change the search string
  81.    during a search while Nosey is paused.
  82.  
  83.  ~ BOOLEAN SEARCH
  84.    Nosey supports Boolean logic AND,OR and NOT. Boolean words are
  85.    entered into a search string by holding the Control key while
  86.    pressing the A, O or N key.
  87.  
  88.           AND     Control/a     shows up facing arrow
  89.           OR      Control/o     shows left side of Atari symbol
  90.           NOT     Control/n     shows right side of Atari symbol
  91.  
  92.    Boolean operators help you to define the search string more clearly.
  93.  
  94.                            calamus<control/a>font
  95.                            /          |          \
  96.                      1st string    Boolean     2nd string
  97.                                    symbol
  98.  
  99.    This example will only show a match if "calamus" AND "font" are in
  100.    the same line of text.
  101.  
  102.    Only one Boolean word can be used and the 1st and 2nd strings must be
  103.    found on the same line during a search (This may be expanded on in
  104.    the future if there is enough interest).
  105.  
  106.  ~ CASE SENSITIVE
  107.    When selected only a match with the same case as the search string
  108.    will be located.
  109.  
  110. -- SEARCH --
  111.  
  112.    When a match is found, an 80 character line containing the search
  113.    string is displayed in inverse text at the bottom of the dialog box 
  114.    and the line proceeding it in the file is displayed above it. NOSEY 
  115.    will search non-ASCII files but expect some strange displays. If
  116.    a file cannot be found or there is some other problem, the file is
  117.    skipped and the search continued.
  118.  
  119.  ~ NEXT MATCH
  120.    When a match is found, NOSEY will pause and wait for "NEXT MATCH" to 
  121.    be selected before continuing the search. The return key also selects
  122.    NEXT MATCH.
  123.  
  124. -- DISPLAY OPTIONS --
  125.  
  126.  ~ SHOW PROGRESS
  127.    The location and line number are continually updated if "Progress
  128.    Reports" is turned on. Progress Reports slows a search considerably.
  129.    When a match is found, the location and line number are always shown.
  130.    Progress reports can be turned on or off by clicking on the line
  131.    number or location box. If you select "Scroll", every line of the
  132.    file will be shown at the selected scroll speed.
  133.  
  134.  ~ DOWN ARROW
  135.    Displays the next line in the file.
  136.  
  137.  ~ UP ARROW
  138.    Moves the display a few lines previous.
  139.  
  140.  ~ PREVIOUS MATCH
  141.    Displays the previous match in case you missed it.
  142.  
  143. -- PRINT OPTIONS --
  144.  
  145.  ~ PRINT
  146.    Prints what is currently displayed to your printer or to a disk file.
  147.    You can use the up and down arrows together with "Print" to print more
  148.    of the file surrounding the match.
  149.  
  150.  ~ L#, T and B Boxes
  151.    If L# is selected the line number of the match is included in the
  152.    printout. If T is selected the line previous to the match (the top
  153.    line of the results display) is printed and B includes the line
  154.    containing the match. You will probably always want B selected and
  155.    line numbers help separate consecutive matches.
  156.  
  157.    NOTE: Nosey is somewhat intelligent while printing. If L# is selected
  158.    and matches are found on 2 or more consecutive lines only the first
  159.    line number is printed. Likewise, Nosey will not print a line if it
  160.    is exactly the same as the last line printed. This cuts down on the
  161.    amount of redundant printing when both T and B are selected.
  162.  
  163.  ~ DISK
  164.    The print to disk option is selectable only while Nosey is paused.
  165.    Enter a name for the destination file or select a file from the file
  166.    selector.  If the file already exists, you can choose to overwrite the
  167.    file, append the new information to the end of the file or to cancel
  168.    the print to disk function. Do not print to a file that is on the
  169.    search list. Print to disk works great to a ram disk.
  170.  
  171.  ~ AUTO
  172.    The auto print function is also selectable only while Nosey is paused.
  173.    When selected, AUTO prints every match to your printer or to the disk
  174.    file if DISK has been selected. Often AUTO print may not give you the
  175.    results you desire because you don't have a choice of what is printed.
  176.    With the manual print function you can use the up and down arrows to
  177.    select what is printed. Sometimes the match and the line after it more
  178.    clearly represent what you are looking for. This is especially true
  179.    with GEnie file lists.
  180.  
  181.  ~ CANCELING A SEARCH
  182.    There are two boxes containing diamonds on either side of "Search
  183.    In Progress". Clicking the left box abandons the search and selecting
  184.    the right box advances the search to the next f